home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d2 / njramd12.arc / NJRAMD.DOC < prev    next >
Text File  |  1988-02-26  |  11KB  |  280 lines
  1.  
  2.  
  3.    Nifty James' Famous (Enhanced) Expanded Memory RAM Disk Drive
  4.  
  5.    Version 1.20  of  16 Oct 1987
  6.  
  7.    (C)  Copyright 1987 By Mike Blaszczak.  All Rights
  8.    Reserved.  This is a Shareware Program. A $15 donation
  9.    is requested.
  10.  
  11.    THIS PROGRAM MAY NOT BE RESOLD WITHOUT THE PRIOR WRITTEN
  12.    CONSENT OF THE AUTHOR.  "REPUBLISHING" SHAREWARE PROGRAMS
  13.    WITHOUT THE AUTHOR'S KNOWLEDGE IS A CRIME.
  14.  
  15.  
  16. Introduction
  17. ------------
  18.  
  19.    NJRAMD is a device driver that allows you to partition a
  20.    part of your EMS or EEMS memory as an extremely
  21.    efficient, extremely fast "RAM disk" drive.  Having a
  22.    part of your memory configured as a RAM disk will allow
  23.    you to store temporary files, intermediate files, and
  24.    other information quickly.
  25.  
  26.    NJRAMD is compatible with the Lotus/Intel/Microsoft EMS
  27.    standard, as well as the AST/Quadram/Ashton-Tate EEMS
  28.    standard.  NJRAMD will function equally well with both
  29.    systems.
  30.  
  31.    This program will also run with any version of DOS,
  32.    staring with version 2.00 or later.  I wrote it under
  33.    PC-DOS 3.1, and tested it under PC-DOS 2.00 and PC-DOS
  34.    2.10.  The program should work with MS-DOS, but it
  35.    hasn't been "officially" tested.
  36.  
  37.    NJRAMD takes up very little DOS space -- the program,
  38.    depending on the configuration that you use, takes
  39.    around 720 bytes of DOS memory, regardless of how large
  40.    the disk space is made.  The smallest configuration of
  41.    NJRAMD takes under 700 bytes of DOS memory.  Thus, you
  42.    can partition a very large RAM disk, and only take up a
  43.    very small portion of precious DOS memory.
  44.  
  45.  
  46. Use and Installation
  47. --------------------
  48.  
  49.    NJRAMD is installed as a DOS device driver when DOS is
  50.    first loaded.  Thus, you must specify the device driver
  51.    in the CONFIG.SYS file of your boot disk or diskette.
  52.    The entry in the CONFIG.SYS file must be anywhere
  53.    *after* the specification for the EMS device driver.
  54.    For example, the EMS driver that came with my Taiwanese
  55.    EMS clone is called INITIAL.SYS.  I also use ANSI.SYS,
  56.    which I specify in the CONFIG.SYS file, also.  Thus, my
  57.    CONFIG.SYS file looks like this:
  58.  
  59.                       device=\sys\initial.sys
  60.                       device=\sys\ansi.sys
  61.                       device=\sys\njramd.sys
  62.  
  63. |  Starting with version 1.20, this version, NJRAMD also
  64. |  comes with a file specially prepared for computers with
  65. |  extended instruction sets.  This includes processors
  66. |  like the 80186, 80286, and 80386.  You can also make
  67. |  use of this version if you have a NEC V-20 or V-30
  68. |  installed and running in your system.
  69.  
  70. |  The version is called NJRAMDXP.SYS.  "XP" stands for
  71. |  "Enhanced Processor".  This version of NJRAMD is coded
  72. |  to take advantage of the special, extra instructions that
  73. |  some CPU's have.  It is slightly smaller, and
  74. |  considerably faster than the standard version.  If this
  75. |  version doesn't work on your system, use the regular
  76. |  version.
  77.  
  78. |  Even if you only have a stock PC with a NEC V-20, you
  79. |  can expect the newver version of NJRAMD to be up to 5%
  80. |  faster in benchmark tests.  On a real 80286 system, the
  81. |  program will run up to 9% faster.
  82.  
  83. |  See the paragraph just before "Technical Information" if
  84. |  you have a PC's Limited computer.
  85.  
  86.    You might also have settings for the BUFFERS, FILES,
  87.    STACKSPACE, and BREAK settings in your CONFIG.SYS file.
  88.    These settings can remain unchanged, as they are
  89.    independent of NJRAMD.
  90.  
  91.    You can find more information on the uses of the
  92.    CONFIG.SYS file in the DOS manual.  The section is
  93.    called "Configuring your system".
  94.  
  95.    If you install NJRAMD as shown above, NJRAMD will
  96.    default to a disk of 32 EMS Pages, which is 512
  97.    kilobytes.  (One EMS Page is equal to 16 kilobytes of
  98.    storage space.  16 kilobytes stores 16384 bytes, or
  99.    characters, of information.)  If you would like to have
  100.    a larger or smaller RAM disk, you must specify the /P
  101.    option on the same line as NJRAMD in your CONFIG.SYS
  102.    file.  NJRAMD allocates space in one-page increments.
  103.    Since each EMS page is 16k bytes long, you can adjust
  104.    the size of NJRAMD in 16k increments.
  105.  
  106.    For example, to specify a RAM disk that is 100 pages
  107.    long, use this line in your CONFIG.SYS file:
  108.  
  109.                       device=njramd.sys /P100
  110.  
  111.    NJRAMD will try to take 100 pages of EMS memory -- this
  112.    will give you 1600k of RAM disk space.
  113.  
  114.    Of course, you must have enough free EMS memory at the
  115.    time that NJRAMD is loaded to accomodate the requested
  116.    size.  If there isn't enough memory, NJRAMD will
  117.    terminate with an error, and not install itself at all.
  118.    If you have selected a size that is too big to fit, you
  119.    will see the message
  120.  
  121.              Device not installed.
  122.              Requested size too big to fit.
  123.  
  124.    Remember that if you don't tell NJRAMD otherwise, it
  125.    will try to create a 512k RAM Disk.
  126.  
  127. |  In version 1.20 of NJRAMD, you can use the /A switch to
  128. |  use *all* of the available EMS memory, automatically,
  129. |  instead of specifying a /P option.  Note, though, that
  130. |  the /A option will not leave any memory for other EMS
  131. |  programs, such as disk cache programs or for 1-2-3.
  132.  
  133.    If there is no EMS memory available, at all, when NJRAMD
  134.    tries to load, you will see this message:
  135.  
  136.             Device not installed.
  137.             No free EMM Memory.
  138.  
  139.    If you see this message:
  140.  
  141.             Device not installed.
  142.             The EMM is not installed.
  143.  
  144.    the EMM for your system was not present when NJRAMD
  145.    loaded.  NJRAMD depends on the EMM for access to the EMS
  146.    memory.  The specification for your EMM driver *must*
  147.    appear before the specification for NJRAMD in your
  148.    CONFIG.SYS file.
  149.  
  150.    Once you have entered the proper information in your
  151.    CONFIG.SYS file, you must reboot your computer so that
  152.    the information in the file will take effect.  When
  153.    NJRAMD installs, it will print a copyright message, and
  154.    some status information reguarding the memory that it
  155.    has taken, and the amount of memory that is available as
  156.    a RAM disk.
  157.  
  158.    If you have any problems installing NJRAMD, please feel
  159.    free to write to me.  I'd be happy  to help!
  160.  
  161.  
  162. Clicking
  163. --------
  164.  
  165.    I programmed NJRAMD to click the system's speaker every
  166.    time the disk was accessed.  Since a RAM disk is silent,
  167.    it's often hard to tell when it is working.  To
  168.    compensate for the fact that there is no "whirring" or
  169.    "chirping" going on while the RAM disk is active, the
  170.    speaker clicks while the program accesses the memory.
  171.  
  172.    If you find this annoying, you can turn it off by
  173.    specifying the "/S" option in the CONFIG.SYS entry.  For
  174.    example,
  175.                          device=njramd.sys /P16 /S
  176.  
  177.    would create a 16-page (256k byte) RAM disk that does
  178.    not click when it is accessed.  If you specify the /S
  179.    option, NJRAMD will print the message
  180.  
  181.             Clicking Suppressed.
  182.  
  183.    when it is installed.
  184.  
  185. |  If you have an PC's Limited computer, with a Smart-Vu
  186. |  display, try using the program NJRAMDPL.SYS.  This
  187. |  version is the same as the other versions, but it
  188. |  writes to the Smart-Vu display.  When NJRAMD is writing,
  189. |  the display will show "NJ-W", and when it is reading, it
  190. |  will show "NJ-R".  Other than the statements that take
  191. |  care of the display, this version of the program is
  192. |  identical to NJRAMDXP.SYS.
  193.  
  194. |  If you have a PC's Limited and do not want NJRAMD to
  195. |  access the Smart-Vu display, use the NJRAMDXP.SYS
  196. |  program.
  197.  
  198.  
  199.  
  200. Technical Information
  201. --------- -----------
  202.  
  203.    I have included the assembly language source code in
  204.    this .ARC file (or on your white distribution disk) for
  205.    your reference.  You do not need it to run the program.
  206.    If you are a programmer, or simply have an interest in
  207.    "what makes it go", you can take a look at the
  208.    NJRAMD.ASM file.  I've heavily commented it, and
  209.    therefore will not describe it in greater detail here.
  210.  
  211.  
  212. Shareware
  213. ---------
  214.  
  215.    This program is a work of Shareware.  If you use the
  216.    program, I expect you to end a donation.  I'm asking $15
  217.    for the program, but, if you would like to send $5 or
  218.    $25, that's fine, too.
  219.  
  220.    Registering your copy of NJRAMD will automatically
  221.    entitle you to free updates.  There currently is one
  222.    change planned for later release, and that is making the
  223.    drive survive "warm boots".  That is, the next version
  224.    of NJRAMD will not be erased if you use
  225.    <CTRL>+<ALT>+<DEL> to reset your system.
  226.  
  227.    This planned change is unfeasible, however.  Since the
  228.    EMS manager overwrites the information in the expanded
  229.    memory when it is installed, the RAM Drive's contents
  230.    will always be erased after a warm boot.
  231.  
  232.    If you would like to write to me, my address is
  233.  
  234.          Mike Blaszczak
  235.          112 Verlinden Drive
  236.          Monroeville, PA   15146-2041
  237.  
  238.    I'm also available on Participate On The SOURCE as NIFTY
  239.    JAMES.  My SOURCE ID is BCB922, and you're welcome to
  240.    send me SMAIL.  I'm also available on the NWI
  241.    Conferencing System, as NIFTY JAMES or MIKE B.
  242.  
  243.    Please feel free to send your comments, questions,
  244.    suggestions, donations, marriage proposals, and
  245.    get-rich-quick schemes.
  246.  
  247.    I'm really interested in hearing any ideas that you
  248.    have about NJRAMD, as well as any questions you have
  249.    about it.  If you run into any problems, please feel
  250.    free to call or write.  (I don't give my phone number,
  251.    but, if you're serious enough, call directory
  252.    assistance.)
  253.  
  254.  
  255. A Special Note
  256. --------------
  257.  
  258.    This program would not have been possible without the
  259.    outstanding generosity and good will of Doctor File
  260.    Finder and Bob Brody.
  261.  
  262.    Hats off to a couple of wonderful people!
  263.  
  264.    Doctor File Finder managed to find a bug in the first
  265.    version that sometimes caused the program to trash the
  266.    files on the disk -- the GetSector procedure wasn't
  267.    working properly.  The problem has been corrected in
  268.    this version, and the program's optimization in the
  269.    GetSector proceudre is now fully functional.
  270.  
  271.    Again, the Good Doctor helped me track down the bug that
  272.    sometimes caused this device driver to ignore the /Page
  273.    option.  Thanks, Doc!  The fix was made, and this is
  274.    now Version 1.15.
  275.  
  276. |  Version 1.20 just let me flex my 80286 knowledge by
  277. |  adding the additional instructions.  The program also is
  278. |  the first version to be developed under Microsoft Macro
  279. |  Assembler Version 5.00.
  280.